Collection::RemoveAll

Section: ET++ method description (n)
Updated: automatically Fri Mar 1 10:57:30 1991
Index Return to Main Contents

NAME

Collection::RemoveAll - instance method

TEMPLATE

void RemoveAll(CollPtr elementsToBeRemoved)

SPECIFIERS

public virtual

DESCRIPTION

Attempts to remove all elements of elementsToBeRemoved from the receiver.
RemoveAll is based on method Remove. The order of the elements to be removed is determined by the iterator returned by MakeIterator of elementsToBeRemoved.
A RemoveAll sends the default change message one time if the size of the receiver has changed. See also method AddAll and method FreeAll.
RemoveAll is declared virtual for provision of more efficient implementations.
Hint: Comparing the receiver's Size before and after a RemoveAll operation might be interesting in some cases. Method is rarely overridden.

ARGUMENTS

CollPtr elementsToBeRemoved: A collection whose elements are to be removed from the receiver.

RETURN ARGUMENT

void

FIRST DEFINITION

class Collection

FILES

implementation:: Collection.C

KNOWN PROBLEMS

There is no comparable operation that is based on RemovePtr.
It depends on the implementation of Remove, wether change message are sent. If they do, they do it for each succesful Remove operation. This is neither correct.

This document was created by man2html, using the manual pages.
Time: 00:40:30 GMT, March 30, 2022